home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / program / dasmblr.arc / DIS.DOC next >
Text File  |  1988-06-12  |  7KB  |  168 lines
  1.   
  2.                 Instructions for DIS, a 68000 dissassembler
  3.   
  4.                      Version 2.20 - 5th June 1988
  5.   Introduction
  6.   
  7.      DIS is a 68000 disassembler which is distributed as 'shareware'. You
  8.   can copy it to others freely provided that you do  not  modify  it  and
  9.   provided that they too abide by  this  condition.  DIS  is  not  in the
  10.   public domain and must  not  be  sold  for  profit  without the written
  11.   permission of the author.  DIS  has  been  tested  fairly  well but its
  12.   operation is not guaranteed in any way.  No doubt bugs still remain and
  13.   if you find  any  please  let  me know of them and the circumstances in
  14.   which they occur.
  15.   
  16.   Operation of DIS
  17.   
  18.      On entry DIS displays a > prompt and awaits  a  command  line  which
  19.   consists  of  a  letter followed by further parameters depending on the
  20.   command.  Parameters are separated by either commas or blank spaces and
  21.   numeric inputs  and  outputs  are normally in hexadecimal form.  In the
  22.   following command descriptions 'x1', 'x2' etc. represent numeric number
  23.   parameters.
  24.   
  25.   Command         Function
  26.   
  27.   I x1 x2         Disassemble Instructions from x1 to x2
  28.   
  29.   B x1 x2         Disassemble data Bytes  (8 bits) from x1 to x2
  30.   
  31.   W x1 x2         Disassemble data Words (16 bits) from x1 to x2
  32.   
  33.   L x1 x2         Disassemble Long words (32 bits) from x1 to x2
  34.   
  35.   C x1 x2         Disassemble in Character format from x1 to x2
  36.   
  37.   A x1 x2         Disassemble a table of Addresses from x1 to x2
  38.   
  39.   E x1 x2         Output label Equates for address ouside range x1 to x2
  40.   
  41.   J x1 x2         Compile labels (Jumps) from x1 to x2 into symbol table
  42.   
  43.   F x1 x2 xx..    Find positions of hex sequence xx.. between x1 and x2
  44.   
  45.   F x1 x2 "cc.."  Find positions of the string "cc.." between x1 and x2
  46.   
  47.   U x1 x2         Set range limits for disassembly
  48.   
  49.   U               Reset to initial range limits
  50.   
  51.   M x1            Enter (Make) a symbol at address x1
  52.   
  53.   O x1            Set an Offset value for disassembly at a different
  54.                   execution address (enter execute address or prefix
  55.                   x1 with + or - to set an actual offset value. This
  56.                   command is for use with absolute labels as results
  57.                   with relative labels can be confusing (the setting
  58.                   of an execution address (ie. O without +/-) in the
  59.                   relative label mode is not recommended.  Note that
  60.                   offset = memory_position - execution_position
  61.   
  62.   Y x1            Set sYmbol form x1 = 0: short relative
  63.                                   x1 = 1: long relative
  64.                                   x1 = 2: long absolute
  65.    
  66.   N x1            Disassembly control -- X1 can be a sum of the values 1,
  67.                   2, 4 and 8 to produce the desired effect as follows:
  68.   
  69.                         x1 = 1:   enter labels into the symbol table
  70.                         x1 = 2:    display internal labels in output
  71.                         x1 = 4:    display external labels in output
  72.                         x1 = 8:  use any symbols loaded with program
  73.                   
  74.                   where internal and external labels reference addresses
  75.                   inside and outside the program area respectively.  The
  76.                   program  symbols will only be available if the program
  77.                   contains a symbol table.
  78.   
  79.   H+  H-          Turn Hexadecimal code output on (+) or off (-)  during
  80.                   the disassembly of instructions
  81.   
  82.   D+  D-          Turn character code output on (+) or off (-) during the
  83.                   disassembly of instructions
  84.   
  85.   P program_name  Load a Program for disassembly
  86.   
  87.   P-              Unload a Program (or image file)
  88.   
  89.   R file_name     Load (Read) a binary image file for disassembly
  90.   
  91.   R-              Unload a binary image file (or program)
  92.   
  93.   S file_name     Output (Save) disassembly from here onwards to a 
  94.                   specified file
  95.   
  96.   S-              Turn off saving and close output file
  97.   
  98.   Q               Output (Query) file name and range information
  99.   
  100.   K               Delete (Kill) all symbol table entries
  101.   
  102.   X               Exit
  103.   
  104.   V               Output Version/author information
  105.   
  106.   T               Compile an auto_disassembly control Table (see later)
  107.   
  108.   T-              Clear auto Table
  109.   
  110.   G               Run (Go) auto disassembly (see later)
  111.   
  112.      When a program or image  file  is loaded and the relative label form
  113.   is set (Y = 0 or Y = 1) address values are relative to the start of the
  114.   file;  when no program or file is loaded then relative labels take zero
  115.   as a base and are therefore effectively absolute.   Input  values  will
  116.   either be absolute or relative depending on  the  value  set  by  the Y
  117.   command.   In  relative  input  mode an absolute number can be input by
  118.   preceeding it with a '$' sign. If the second number of an input pair is
  119.   preceeded by  a  '+'  sign the value input is added to the value of the
  120.   first parameter to form the  second  parameter.  If  a  '*'  is entered
  121.   instead  of  an  input value then the current  value  of  the  relevant
  122.   parameter is used.
  123.   
  124.      Pressing  the  SPACE  bar  during disassembly will pause the output;
  125.   pressing space again will resume output while any other key will return
  126.   to  command  mode.   Pressing  ESC  during   disassembly   will  return
  127.   immediately  to command mode.  During disassembly the x1  parameter  is
  128.   continuously updated  so  that  a  stopped disassembly can be restarted
  129.   with using a * in the first parameter position. In number pair commands
  130.   if no second  value  is given then a convenient number of lines will be
  131.   disassembled to the  screen.  A  RETURN  entered  at the >  prompt will
  132.   repeat the previous command.
  133.   
  134.   Automatic Disassembly
  135.   
  136.       The T command allows a table to be  input  in the following form to
  137.   control dissassembly:
  138.   
  139.                 L1 x1
  140.                 L2 x2
  141.                 ...
  142.                 Ln xn
  143.   
  144.   where  Ln is one of the letters (I,B,W,L,C,A,X) and xn is a hexadecimal
  145.   number as normal.   After  a  table  has  been input a G command starts
  146.   dissassembly.  Each entry  in  the  table is processed in turn with the
  147.   letter determining  the type of dissassembly and the address indicating
  148.   where  to  start.  The  address  for  the  next  entry determines where
  149.   dissassembly finishes and  restarts  in  a new form with the last entry
  150.   (an X) indicating the end of  the  process.  When entering the table an
  151.   entry can be corrected by simply entering  a  new  entry  with the same
  152.   address value (or a Z with the same address if it is to be removed). To
  153.   end table input simply type a RETURN  in  response  to the prompt.  The
  154.   output can be saved if  required  by  issuing  an  S command before and
  155.   after the G command.
  156.   
  157.   Bug Reports and Contibutions to:
  158.   
  159.                 Brian Gladman
  160.                   8 College Grove
  161.                     Great Malvern
  162.                       Worcs WR14 3HP
  163.                         United Kingdom
  164.   
  165.   
  166.   Revision 4 (5th June 1988)
  167.   
  168. ə